---
title: "List workspace members"
method: GET
path: "/api/v3/meta/workspaces/{workspaceId}?include[]=members"
tags: ["Workspace Members"]
---

# List workspace members

`GET /api/v3/meta/workspaces/{workspaceId}?include[]=members`

## Request

- Base URL: `https://app.nocodb.com`
- URL: `https://app.nocodb.com/api/v3/meta/workspaces/{workspaceId}?include[]=members`
- Auth: one of:
  - API key in header `xc-token`
  - HTTP bearer
- TypeScript: <https://skmtc.dev/nocodb/apis/nocodb-v3/docs/api/v3/meta/workspaces/:workspaceId%3Finclude[]=members/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve details of a specific workspace, including its members.

Notes:
- To include member details, use the query parameter `include[]=members`.
- Workspace collaboration APIs are available on cloud-hosted **Business** plans and above, and on licensed self-hosted deployments (**Business** plan and above).

## Path parameters

- `workspaceId` string, required

## Query parameters

- `include` union
  - 'members'
  - string[]

## Response `200`

Workspace metadata retrieved successfully.

- WorkspaceWithMembers: Basic workspace information
  - `id` string, required: Unique identifier for the workspace
  - `title` string, required: Title of the workspace
  - `created_at` string, date-time, required: Timestamp when the workspace was created
  - `updated_at` string, date-time, required: Timestamp when the workspace was last updated
  - `individual_members` object, required
    - `workspace_members` WorkspaceMember[], required: List of workspace members
      - `email` string, email, required: Email address of the member
      - `user_id` string, required: Unique identifier for the user
      - `created_at` string, date-time, required: Timestamp when the user was added to the workspace
      - `updated_at` string, date-time, required: Timestamp when the user was last updated in the workspace
      - `workspace_role` 'workspace-level-owner' | 'workspace-level-creator' | 'workspace-level-editor' | 'workspace-level-viewer' | 'workspace-level-commenter' | 'workspace-level-no-access' | 'workspace-level-inherit', required: Workspace role as reported on a member read. A superset of `WorkspaceRoles`: `workspace-level-inherit` means the role is inherited from the organization rather than set on the workspace. It cannot be assigned — it is never valid in a request body.

## Other responses

- `404`: Workspace not found.
- `500`: The server encountered an unexpected error while processing the request.

## Changes

- **2026-10-13** `2ba4267a99d7`: 1 warning
  - added the new `workspace-level-inherit` enum value to the `allOf[subschema #2]/individual_members/workspace_members/items/workspace_role` response property for the response status `200`

[Operation history](https://skmtc.dev/nocodb/apis/nocodb-v3/changes/api/v3/meta/workspaces/:workspaceId%3Finclude[]=members/get.md)

---

[API](https://skmtc.dev/nocodb/apis/nocodb-v3.md) - [All operations](https://skmtc.dev/nocodb/apis/nocodb-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/nocodb/apis/nocodb-v3/revisions/62a735aaf849?raw)